home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD 5.bin / workbench / boot / czesc_2 / wiconify / wiconsetter.lzh / wIdentify / wIdentify.doc < prev    next >
Text File  |  1991-04-19  |  4KB  |  106 lines
  1. OVERVIEW:
  2.  
  3. WIDENTIFY is a companion program to WICONIFY and WICONSETTER.  It helps you
  4. to identify the program, screen and window names of existing windows, and of
  5. new windows and screens as they are openned.
  6.  
  7. wIconSetter identifies a window by using the name of the program that opens
  8. the window, the name of the screen where it is openned, and the name of the
  9. window itself.  Usually, it is easy to tell the name of the window and
  10. screen, but more difficult to determine what program opens a window. 
  11. wIdentify is intended to make this easy.
  12.  
  13.  
  14. USING WIDENTIFY:
  15.  
  16. To find out the PROGRAM, SCREEN and WINDOW titles for the active window,
  17. simply issue the command:
  18.  
  19.     1> wIdentify
  20.  
  21. wIdentify will look up the active window and print the results.
  22.  
  23. To specify a window other than the active one, type:
  24.  
  25.     1> wIdentify WINDOW <name>
  26.  
  27. where <name> is replaced by the name of the window about which you want
  28. information.  If the name includes spaces, be sure to enclose the name in
  29. quotation marks.  You need only give as much of the name as needed to
  30. distinguish it from the other windows.  Upper and lower case letters are
  31. treated as the same, so capitalization doesn't matter.
  32.  
  33. If the window is not on the active screen, you will need to tell wIdentify
  34. what screen to look on, as in the following:
  35.  
  36.     1> wIdentify WINDOW <window_name> SCREEN <screen_name>
  37.  
  38. The same rules apply for screen names as for window names.
  39.  
  40. If you give a screen name only, without a window name, then wIdentify will
  41. print the information for ALL the windows on the specified screen.  For
  42. example, the following command identifies all windows on the Workbench screen:
  43.  
  44.     1> wIdentify SCREEN "Workbench"
  45.  
  46. You can get information about every window on every screen by giving the
  47. following command:
  48.  
  49.     1> wIdentify ALL
  50.  
  51.  
  52. Although the screen and window names are always available from the data
  53. associated with a window, it is not always possible to determine the program
  54. that owns a window from an existing window.  When this is the case,
  55. wIdentify will list the program name as "[Unknown]".  This is true, for
  56. example, for all CON: and RAW: windows.  These are created by programs named
  57. 'CON' (or 'NEWCON') and 'RAW', but their names can not be determined from
  58. the windows after they are openned.
  59.  
  60. wIconSetter traps the OpenWindow() Intuition library routine, and when this
  61. is called, wIconSetter finds the program name from the Process or Task data
  62. structure of the program that called OpenWindow().  This always gets the
  63. program name, even for CON: and RAW: windows. 
  64.  
  65. If wIdentify reports a window's program as "[Unknown]", you will need to use
  66. wIdentify in a different fashion:
  67.  
  68.     1> RUN wIdentify NEW
  69.  
  70. This will start wIdentify as a seperate process (but its output will still
  71. go to the CLI window where you ran it).  When you specify the option NEW,
  72. wIconify will trap the OpenWindow(), OpenScreen() and SetWindowTitles() calls,
  73. just like wIconSetter does, and will report the identities of all windows and
  74. screen as they are openned, and windows whose titles change.
  75.  
  76. This is the most accurate information about windows and screens, but it gives
  77. information only as they open or their titles change, not about ones that are
  78. already open.  Since this is what wIconSetter uses, however, this is the best
  79. source of a window's or screen's "true" identity.
  80.  
  81. To end the wIdentify process, use the BREAK command to send a CTRL-C to the
  82. wIdentify process.  For example, if the RUN command says that CLI 3 was
  83. created, then use the command
  84.  
  85.     1> BREAK 3 C
  86.  
  87. to stop wIdentify.
  88.  
  89. Note:  some programs, for example the calculator distributed on the WB 1.3
  90. disk, open their windows with no title, and then add the title afterwards.
  91. wIdentify NEW will report these windows twice:  once when they open (with
  92. NULL titles), and then again as the titles change.
  93.  
  94. If you have trouble adding an icon to a window and you think you have
  95. specified it correctly, use WIDENTIFY NEW to check that the name is really
  96. what you expect.
  97.  
  98.  
  99. AUTHOR:
  100.  
  101. Davide P. Cervone
  102. Mathematics Department
  103. Brown University
  104. Providence, Rhode Island 02912
  105. ST402523@BROWNVM
  106.